home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / pvm34b3.zip / pvm34b3 / pvm3 / gexamples / Readme < prev    next >
Text File  |  1997-07-22  |  3KB  |  70 lines
  1. Directory: pvm3/gexamples
  2.  
  3. This directory contains several example programs for using dynamic group
  4. services. The following is a list with short descriptions of what each
  5. program illustrates:
  6.  
  7.       frsg.f   -  Fortran example of reduce, scatter, and gather operations. 
  8.                   Sum of sqaures for first N integers. N defaults to 
  9.                   20 with 4 processors if frsg is spawned from the console. 
  10.  
  11.                   Synopsis:
  12.                         frsg 
  13.  
  14.       trsg.c   -  C version of the frsg program
  15.  
  16.                   Synopsis:
  17.                         trsg
  18.  
  19.       gexamp.c -  Instance 0 spawns nproc-1 copies of gexamp. All group
  20.                   members then perform a barrier. All members
  21.                   broadcast a copy of their tid and instance to the
  22.                   entire. Each process checks the incoming message
  23.                   against its own data.
  24.                    
  25.                   Synopsis: 
  26.                         gexamp <nproc>
  27.  
  28.       joinleave.c -  One process continually joins and leaves the same
  29.                   group. A diagnostic is printed every 100 join/leave pairs.
  30.                   Will join and leave the group 10000 times, unless a 
  31.                   different count is specified on the command line.
  32.  
  33.                   Synopsis:
  34.                         joinleave [njoins]
  35.       thb.c
  36.       tnb.c    -  thb joins 32 different groups.  It checks the
  37.                   group server for consistency using pvm_gettinst and
  38.                   pvm_gettid.  It then spawns <nproc> tnb process and 
  39.                   sends them some intialization information. The tnb 
  40.                   processes receive the initialization
  41.                   data and then perform a barrier with themselves and
  42.                   the thb process.
  43.               
  44.                   Synopsis:
  45.                         thb <nproc>
  46.  
  47.  
  48. HOW TO COMPILE
  49.  
  50.    $PVM_ROOT/lib should be in your path so that the aimk program can be
  51.    located. Then,
  52.  
  53.           % aimk all                # make  all the test programs
  54.          
  55.           % aimk frsg               # make just frsg
  56.  
  57.  
  58. NOTES FOR PARAGON USERS
  59.  
  60.    All the codes are compiled to run as compute node programs. You
  61.    must therefore  spawn the programs from the pvm console.  For
  62.    example to run the gexamp program type at the pvm console
  63.  
  64.     % pvm              # start a pvm console, in $PVM_ROOT/lib/$PVM_ARCH/pvm
  65.       pvm> spawn -> gexamp <4>
  66.  
  67.  
  68.   The -> redirects all output of the tasks to the pvm console window.
  69.  
  70.